Obtener texto

UiPath.UIAutomationNext.Activities.NGetText

Descripción

Extrae y copia el texto de un elemento de la interfaz de usuario.

Esta actividad debe añadirse dentro de una actividad Usar aplicación/navegador.

Esta actividad es compatible con el repositorio de objetos.

Compatibilidad de proyectos

Windows: heredado | Windows | Multiplataforma

Windows (heredado), configuración de Windows

Panel del Diseñador

• Haz clic en Indicar en aplicación / navegador para indicar el elemento de IU que se utilizará como destino.

  Después de indicar el destino, seleccione el menú para acceder a las siguientes opciones:

  • Indicar destino en pantalla: indica de nuevo el destino.
  • Editar objetivo : abre el modo de selección para configurar el objetivo.
  • Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.
  • Añadir al repositorio de objetos : añade el elemento de IU actual a un proyecto de biblioteca, desde donde pueda reutilizarse en todo el proceso de automatización.
  • Extracción de vista previa : abre el asistente de Vista previa Obtener texto - Extracción , que te permite ver qué texto se recupera del destino en tiempo real.
• Guardar en : te permite almacenar el texto del elemento de IU especificado en una variable. Las variables creadas en este campo son de tipo String .

Vista previa de extracción

El asistente Obtener texto: vista previa de extracción te permite elegir el método de extracción que deseas utilizar y también muestra en tiempo real el texto que se muestra utilizando el método elegido. El texto extraído se muestra en el cuadro de vista previa de extracción de texto y se puede copiar con el botón Copiar al portapapeles .

Si no se utiliza el asistente, se prueban todos los métodos de extracción por defecto y se elige automáticamente el mejor. Elegir un método de extracción en la ventana de vista previa de extracción anula este mecanismo y hace que ese método sea el único que se utiliza.

Están disponibles los siguientes métodos:

• Predeterminado
• Atributo de texto
• Texto completo : este método ofrece la opción de Ignorar el texto oculto, que se puede activar seleccionando su casilla de verificación respectiva.

• Nativo : este método te permite permitir el formato y recuperar las coordenadas de la pantalla de las palabras seleccionando las casillas de verificación para cada una de estas características.

  
  

  

  
  

Después de seleccionar el método que desea utilizar para la extracción, al pulsar Guardar y cerrar se cierra el asistente y se propagan los cambios que ha realizado en el Panel de propiedades de la actividad.

Panel de propiedades

Común

• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

• Retraso después de : retraso (en segundos) entre el momento en que se completa esta actividad y el momento en que la siguiente actividad inicia cualquier operación. El valor predeterminado es 0,3 segundos. Agregar un retraso entre actividades garantiza que una actividad tenga tiempo suficiente para completarse antes de que comience la siguiente.

• Retraso antes de: retraso (en segundos) entre la hora a la que se termina la actividad anterior y la hora a la que esta actividad empieza a ejecutar operaciones. El valor predeterminado es 0,2 segundos. Añadir un retraso entre actividades garantiza que una actividad tiene tiempo suficiente para completarse antes de que comience la actividad siguiente.

• Nombre paramostrar : el nombre que se muestra para la actividad en el panel Diseñador. Se genera automáticamente un nombre para mostrar cuando indica un destino.

• Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

  También puede elegir un valor predeterminado en el menú desplegable: 10 (s), 20 (s) o 30 (s).

Entrada

• Método de extracción: describe el método de extracción que quieres utilizar. Están disponibles las siguientes opciones:

  • Predeterminado : pasa por posibles métodos de extracción (atributo de texto, texto completo, en ese orden) y se detiene en el primer método que devuelve datos. La única razón para cambiar el método predeterminado es si devuelve un texto, pero no el correcto. Si el método predeterminado no devuelve nada, lo mismo se aplica a los demás métodos de extracción.
  • Atributo de texto : extrae el valor del atributo de texto para el elemento de la IU especificado.
  • Texto completo : extrae el texto completo del elemento de la IU, incluidos sus elementos secundarios. Este método es útil cuando quieres extraer el texto completo de un elemento contenedor que contiene múltiples elementos secundarios.
  • Nativo : extrae el texto visible para el elemento de la IU especificado.
• Destino : el elemento de destino. Se debe establecer el elemento de destino. Antes de indicarlo en la pantalla, este campo se establece como (null). Una vez que se indica el destino, se muestran todas las propiedades relacionadas con el elemento que se indicó.
  Nota: si esta actividad tiene como destino una casilla de verificación seleccionada, el texto devuelto es checked. Si esta actividad tiene como destino una imagen, se devuelve el texto alt de la imagen.
  • Tipo de control CV : indica el tipo de control identificado mediante Computer Vision.
  • Texto de CV : indica el texto identificado mediante Computer Vision.
  • Selector difuso : los parámetros para el selector difuso.
  • Texto nativo : el texto que se utiliza para identificar el elemento de la interfaz de usuario.
  • Páginas web dinámicas: habilita el diseño de páginas web dinámicas.
  • Selector estricto: el selector estricto generado para el elemento de IU.
  • Métodos de destino: los tipos de selectores que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación del menú desplegable:
    • Ninguno
    • Selector estricto
    • Selector difuso
    • Imagen
    • Texto nativo
    • Computer Vision
  • Comprobación devisibilidad: comprueba si el elemento de la IU está visible o no. Puedes elegir una de las tres opciones del menú desplegable:
    • Ninguno : no comprueba la visibilidad.
    • Interactivo (para selector difuso) : opción predeterminada. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando intenta asegurarse de que no está apuntando a elementos invisibles que existen en el DOM pero que están ocultos.
    • Totalmente visible : comprueba si el elemento de la IU está visible o no.
  • Esperar a que se cargue la página : antes de realizar las Actions, espera a que la aplicación esté lista para aceptar la entrada. Puedes elegir una de las tres opciones del menú desplegable:
    • Ninguno: No espera a que el objetivo esté listo.
    • Interactivo: espera hasta que se cargue solo una parte de la aplicación.
    • Completo: espera a que se cargue la aplicación completa.
  • Selector de ventana (instancia de aplicación) : el selector que se utiliza para la ventana de la aplicación. Solo se aplica cuando el modo de agregación de ventana está establecido en Instancia de aplicación.

Elemento de entrada/salida

• Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
• Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

Salida

• Texto : consulta Guardar en en el panel Diseñador.
• Información depalabras : la información adicional del texto recuperado, como las coordenadas de la pantalla, se guarda en la variable proporcionada en este campo. Este campo solo admite NWordInfo variables.

Configuración multiplataforma

• Trabajar en el ámbito : elija la pestaña del navegador que representa la aplicación web que se va a automatizar.

• Indicar destino en pantalla : indica el elemento de la IU que se usará como destino.

  Después de indicar el destino, selecciona el botón más para acceder a las siguientes opciones:

  • Indicar destino en pantalla: indica de nuevo el destino.
  • Editar objetivo : abre el modo de selección para configurar el objetivo.

Opciones adicionales

Plazos

• Retraso antes de: retraso (en segundos) entre la hora a la que se termina la actividad anterior y la hora a la que esta actividad empieza a ejecutar operaciones. El valor predeterminado es 0,2 segundos. Añadir un retraso entre actividades garantiza que una actividad tiene tiempo suficiente para completarse antes de que comience la actividad siguiente.

• Retraso después de : retraso (en segundos) entre el momento en que se completa esta actividad y el momento en que la siguiente actividad inicia cualquier operación. El valor predeterminado es 0,3 segundos. Agregar un retraso entre actividades garantiza que una actividad tenga tiempo suficiente para completarse antes de que comience la siguiente.

• Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Opciones

• Método de extracción: describe el método de extracción que quieres utilizar. Están disponibles las siguientes opciones:

  • Predeterminado : pasa por posibles métodos de extracción (atributo de texto, texto completo, en ese orden) y se detiene en el primer método que devuelve datos. La única razón para cambiar el método predeterminado es si devuelve un texto, pero no el correcto. Si el método predeterminado no devuelve nada, lo mismo se aplica a los demás métodos de extracción.
  • Atributo de texto : extrae el valor del atributo de texto para el elemento de la IU especificado.
  • Texto completo : extrae el texto completo del elemento de la IU, incluidos sus elementos secundarios. Este método es útil cuando quieres extraer el texto completo de un elemento contenedor que contiene múltiples elementos secundarios.

Entrada/Salida

• Valor de texto : te permite almacenar el texto del elemento de IU especificado en una variable. Las variables creadas en este campo son de tipo String .
• Información depalabras : la información adicional del texto recuperado, como las coordenadas de la pantalla, se guarda en la variable proporcionada en este campo. Este campo solo admite NWordInfo variables.
• Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
• Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.